home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / sozosun.zoo / sun.doc < prev   
Text File  |  1991-02-09  |  3KB  |  112 lines
  1. Instructions for compiling Sozobon C on Sun's for use as a cross-compiler.
  2. ==========================================================================
  3.  
  4. 1. Obtain sources for Sozobon C V1.2., these can be found at 
  5.    atari.archive.umich.edu and panarthea.ebay.sun.com among
  6.    others.
  7.  
  8. 2. Obtain dlibs.a, libm.a or any other ST/Alcyon format libraries you
  9.    wish to use. See above ftp sites for these, as well.
  10.  
  11. 3. Create the following directory structure: (you can cut and paste this
  12. as a shell script if you'd like.)
  13.  
  14. mkdir sozobon/
  15. mkdir sozobon/bin
  16. mkdir sozobon/include
  17. mkdir sozobon/include/sys
  18. mkdir sozobon/lib
  19. mkdir sozobon/src
  20. mkdir sozobon/src/hcc
  21. mkdir sozobon/src/jas
  22. mkdir sozobon/src/tools
  23. mkdir sozobon/src/ld
  24. mkdir sozobon/src/top
  25.  
  26. 5. Move the sozobon sources to the appropriate directories:
  27.    all of the .h files associated with the libraries go in the include
  28.    directory.
  29.    all .c files go in the appropriate tool directory under the src tree.
  30.    all .a files and the dstart.o file go under lib
  31.  
  32. 6. unpack the archive.
  33.  
  34. 7. patch the sources, example:
  35.    cd src/hcc
  36.    patch < hcc.diff
  37.    (then answer prompts)
  38.  
  39. 8. run makeall script from the sozobon root directory. (if you want to
  40.   create a debug version of the sozobon tools define the environment
  41.   variable DEBUG as -g )
  42.  
  43. 9. the following binaries should appear in the bin/ directory:
  44.  
  45.  hcc.ttp        han's cc compiler
  46.  scc.ttp        sozobon c compiler driver
  47.  snm.ttp        sozobon 'nm' tool
  48.  sld.ttp        sozobon ld tool
  49.  top.ttp            tony's optimizer
  50.  jas.ttp            joe's assembler
  51.  ar.ttp            sozobon library maintainer
  52.  
  53.  NOTE:
  54.   a. I put the s in front of cc, ld, and nm to avoid naming conflicts with
  55.      my setup. If you don't like the s's just change the makefiles.
  56.  
  57.   b. The glob.ttp tool is not supported for this release.
  58.  
  59.  
  60. 10. try compiling the 'hex.c' file using sozobon: scc.ttp hex.c
  61.   If everything went properly this should produce an ST executable
  62.   called hex.ttp in the same directory. (Unoptimized File size: 8839)
  63.  
  64.  
  65.  
  66. Additional features in Sun version:
  67. ===================================
  68. The compiler driver scc supports the following environment variables:
  69.  
  70. LIBC - defines file name C runtime library to link against
  71.      - i.e. setenv LIBC dlibs.a
  72.  
  73. CSU  - defines file name of 'C startup' code (i.e. dstart.o)
  74.      - i.e. setenv CSU  dstart.o
  75.  
  76. LIBM - defines file name of math library
  77.      - i.e. setenv LIBM libm.a
  78.  
  79. NOTE: scc will prepend the path name in the environment variable LIB
  80. to the above filenames.
  81.  
  82.  
  83. TIPS for using Sozobon C on BSD:
  84. ================================
  85.  
  86. 1. Put the sozobon/bin directory in your PATH environment variable.
  87.  
  88. 2. setup links to the binaries in the bin area without the .ttp extension.
  89.    (ex: 'ln -s scc.ttp scc' then you can just type scc -flags file.c)
  90.    The '.ttp' extension is required for scc to be able to find the other
  91.    tools. I didn't feel like modifying it.
  92.  
  93.  
  94. Caveats:
  95. ========
  96. The Sozobon preprocessor has some problems handling certain constructs. It
  97. seemed to improperly handle the '\' line break mechanism properly, as well.
  98. I think these are part of Sozobon itself. Rather than peculiarities of this
  99. particular port.
  100.  
  101.  
  102.  
  103. Obligatory Disclaimer:
  104. ======================
  105. This port comes with no warranty express or implied, but if you do
  106. have problems feel free to cry on my shoulder. :^)
  107.  
  108. Bug Reports/ Questions/ Fixes : Kent.Dalton@FtCollins.NCR.com (preferred)
  109.                                 72320.3306@compuserve.com
  110.  
  111.  
  112.